package com.zzyl.nursing.service;

import com.baomidou.mybatisplus.extension.service.IService;
import com.zzyl.common.core.page.TableDataInfo;
import com.zzyl.nursing.domain.Reservation;
import com.zzyl.nursing.dto.ReservationDto;
import com.zzyl.nursing.vo.TimeCountVo;

import java.time.LocalDateTime;
import java.util.List;

/**
 * 预约信息Service接口
 * 
 * @author ruoyi
 * @date 2024-06-07
 */
public interface IReservationService extends IService<Reservation>
{
    /**
     * 查询预约信息
     * 
     * @param id 预约信息主键
     * @return 预约信息
     */
    public Reservation selectReservationById(Long id);

    /**
     * 查询预约信息列表
     * 
     * @param reservation 预约信息
     * @return 预约信息集合
     */
    public List<Reservation> selectReservationList(Reservation reservation);

    /**
     * 新增预约信息
     * 
     * @param reservation 预约信息
     * @return 结果
     */
    public int insertReservation(Reservation reservation);

    /**
     * 修改预约信息
     * 
     * @param reservation 预约信息
     * @return 结果
     */
    public int updateReservation(Reservation reservation);

    /**
     * 批量删除预约信息
     * 
     * @param ids 需要删除的预约信息主键集合
     * @return 结果
     */
    public int deleteReservationByIds(Long[] ids);

    /**
     * 删除预约信息信息
     * 
     * @param id 预约信息主键
     * @return 结果
     */
    public int deleteReservationById(Long id);
    
    /**
     * 统计指定时间范围内的预约数量
     * 
     * @param startTime 开始时间
     * @param endTime 结束时间
     * @return 预约数量统计
     */
    List<TimeCountVo> countReservationsForTime(LocalDateTime startTime, LocalDateTime endTime);
    
    /**
     * 批量更新预约状态
     * 
     * @param ids 预约ID列表
     */
    void batchUpdateStatus(List<Long> ids);
    
    /**
     * 查询当天用户取消的预约数量
     * 
     * @param userId 用户ID
     * @return 取消的预约数量
     */
    int getCancelledReservationCount(Long userId);
    
    /**
     * 查询指定日期预约时间段剩余次数
     * 
     * @param time 日期时间戳
     * @return 时间段剩余次数列表
     */
    List<TimeCountVo> countByTime(Long time);
    
    /**
     * 新增预约
     * 
     * @param reservationDto 预约信息
     * @return 是否成功
     */
    boolean addReservation(ReservationDto reservationDto);
    
    /**
     * 分页查询预约
     * 
     * @param pageNum 页码
     * @param pageSize 每页数量
     * @param status 状态
     * @return 分页结果
     */
    TableDataInfo pageQuery(Integer pageNum, Integer pageSize, Integer status);
    
    /**
     * 取消预约
     * 
     * @param id 预约ID
     * @return 是否成功
     */
    boolean cancelReservation(Long id);
    
    /**
     * 查找过期的预约ID列表
     * 
     * @return 过期预约ID列表
     */
    List<Long> findExpiredReservationIds();
    
    /**
     * 更新过期预约状态（定时任务使用）
     * 
     * @return 更新的记录数
     */
    int updateExpiredReservations();
} 